OpenBuildings™ Designer 帮助

标准文件命名实用工具

标准文件命名 (SFN) 实用工具可通过配置获得，支持您快速自动生成名称符合各种文件命名约定的文件、模型和视图名称。您也可以通过 XML 文件添加自己的标准和选项。

启用后，每当您创建新的 DGN 文件、模型、已保存的视图等时，该实用工具便会打开，为您提供待填充的字段，这些字段可用于生成的文件/模型/已保存视图名称，它们符合由 XML 指定的命名约定。

启用实用工具

要启用该实用工具，可定义以下变量：

  • BB_NAMING_STANDARDS_ENABLE - 如果已定义，则支持您创建由 BB_NAMING_STANDARDS_FILE 定义的标准命名约定控制的任何文件、模型和/或视图名称。
  • BB_NAMING_STANDARDS_FILE - 定义 XML 路径和文件，用于定义创建规定文件、模型或视图名称所用的标准命名约定。
可以设置其他配置变量，以提供 SFN 实用工具中的缺省值规则。
  • BB_NAMING_STANDARDS_PROJECT_ID - 支持命名标准实用工具中预置的缺省项目 ID/工作集 ID。定义后，您无法在命名标准对话框中编辑项目 ID/工作集 ID。

“实用工具”对话框

创建新文件或新模型、保存的视图时打开。

此时，您可以通过手动键入或从下拉列表中选择，开始输入有效数据。所有必需的属性均已确认有效值之后（红色文本变为黑色），将启用确定«»按钮，且对话框底部将生成文件名的预览。单击确定，将此生成的文件名复制到“文件保存”对话框。

实用工具 XML 文件

“标准文件命名实用工具”对话框设置由 BB_NAMING_STANDARDS_FILE 配置变量指定的 XML 文件控制。

注释: 缺省情况下，系统会提供示例标准文件命名实用工具 XML 文件 (C:\Program Files\Bentley\OpenBuildings CONNECT Edition\OpenBuildingsDesigner\Default\Data\StandardsFilenameSetting.xml)，您可以使用此示例文件作为模板来创建您自己的文件命名标准 XML 文件。

此文档提供的属性用于控制如何使用 SFN 实用工具来构造文件名。XML 文档本身受 XML 架构（可 [架构位置] 中找到）约束。此架构指定以下内容：

XML 文档必须以下列文本开头：
<?xml version="1.0"?>
<SFNSettings Titles="Some Title">
其中，“Some Title”可以替换为任何字符串，且作为 SFN 实用工具弹出框的窗口标题显示。
<SFNSettings> 节点必须已定义以下 子节点：
  • <Filename>
  • <模型>
  • <ModelDesign>
  • <ModelDrawing>
  • <ModelSheet>
  • <ModelNamedView>

这样，在每个指定场景中创建名称时，SFN 实用工具可拥有不同的规则集。其中每个节点上均可定义一个 GroupName 和/或 ShowDesc 特性。GroupName 在组标题上放置一个标签，而 ShowDesc 则是 True/False 值，可以控制打开 SFN 实用工具时描述面板是否可见。

例如：
<Filename GroupName="FileNames" ShowDesc="true">
…
</FileName>
系统提供了一个根节点 SFNSettings。SFNSettings 包含以下唯一节点。这些控制节点与 RPG 中的属性相对应。在其中每个规则集节点下，均可定义任何数量的控制节点。每个控制节点与该 SFN 弹出窗口中的某一唯一属性相对应。每个控制节点均可有若干特性 (Attr)、窗体和窗口条件节点。如果控制节点的特性数是一个非零数，则属性编辑器将变成一个下拉列表。如果没有任何特性，则编辑器是一个文本框。可以对控制节点应用以下 XML 特性。
XML 特性 - 元素 类型 | 必填？ 描述
SFNSettings 标题： 字符串 | 必填 最初可能有多个窗口，但现在仅使用新特性重新加载属性轴网，因此无需创建新窗体。此特性决定其中每个窗口的标题内容。如果窗口多于标题，则系统会将最后一个标题用于每个后续窗口。标题以逗号分隔。
标签 字符串 | 必填 根据属性提供名称。各个控件的名称必须唯一。如果同一标签在各个控件中多次使用，则仅显示一个含有该标签的控件。
顺序 整型 | 可选 隐式指定属性在轴网中列出的顺序。如果没有指定顺序，则属性将以其在 XML 文档中列出的顺序显示。未排序的属性将始终位于轴网中已排序的属性之后。
CacheValue 布尔型 | 可选 设置为 true 时，将指定此属性应记住 SFN 实用工具中所用的最后输入值
前缀 字符串 | 可选 指定一个字符串，该字符串将位于此属性在构造文件名中的值的前面。例如，当前缀为“_”且值为“Building”时将在结果文件名中生成“_Building”。
后缀 字符串 | 可选 指定一个字符串，该字符串将位于构造的文件名中此属性值的后面。
最小字符数 整型 | 可选 指定此属性值的最小字符长度。
最大字符数 整型 | 可选 指定此属性值的最大字符长度。
必需 布尔型 | 可选 设置为 true 时，将要求输入此属性的有效值。
可扩展 布尔型 | 可选 设置为 true 时，将支持用户为下拉列表属性输入自己的值。
格式 字符串 | 可选 指定格式，限制在用户输入的属性中使用的字符类型：
  • 字母：仅英语字母字符
  • 数值：仅包含 0-9 位数的数字
  • 字母数字：英语字母字符或仅 0-9 位数
注释: 每个控制节点均必须有一个标签特性，但可以使用任何可选特性的组合。
每个控制节点最多可以有 3 种子节点：
  • <Desc>：如果包括该选项，则此节点将包含属性描述，它将显示在 SFN 实用工具底部面板中。
  • <Attr>：每个控制节点可能不包括其中任一 Attr 节点。如果包括任一 Attr 节点，则该属性将以下拉列表的形式显示在 SFN 实用工具中。
    • 如果包括 Value 特性，则此值就是将包括在构造文件名中的值。
    • 示例:
      • <Attr>Option1</Attr>
        使用标记为“Option1”的单个项创建下拉列表，“Option1”将包括在最终的构造文件名中。
      • <Attr Value="O1">Option1</Attr>
        使用标记为“Option1”的单个项创建下拉列表，O1 将包括在最终的构造文件名中。
  • <Condition>：确定属性何时会显示在 SFN 实用工具中。如果指定控制节点，则属性将始终可见。条件节点可能具有以下特性。
    • Type（字符串 | 必填）：可以指定为“窗体”（以显示在 SFN 实用工具的同一窗口中），或指定为“窗口”（以显示在后续弹出窗口中）。
    • ControlLabel（字符串 | 可选）：指定哪个控制标签必须具有值才能显示当前属性
    • Options（字符串 | 可选）：与 ControlLabel 结合使用，以指定必须在指定的控制标签中选中哪些选项才能显示当前属性。

    • ControlVariable（字符串 | 可选）：指定配置变量名称，该变量将填充属性值。

.

示例工作流

OpenBuildings Designer 的标配附带提供 SFN 实用工具配置的示例 XML 文档。为此，您也可以选择创建自己的 XML 文档。

以下是用于 SFN 实用工具的 XML 文档的开头。
<?xml version="1.0"?>
	<SFNSettings Titles="Standard File Naming Utility"> 
		<Filename GroupName="FileNames" ShowDesc="true" > 
			<Control Label="Project Number" Required="true" Order="0" MinChars="4" MaxChars="5" CacheValue="true" Prefix="">
				<Desc>Project Number</Desc> 
			</Control> 
			<Control Label="Discipline" Order="3" Required="true" CacheValue="true" Prefix="-"> 
				<Desc>Select from the following options</Desc> 
				<Attr Value="A" >Architectural</Attr> 
				<Attr Value="S" >Structural</Attr> 
				<Attr Value="M" >Mechanical</Attr> 
				<Attr Value="E" >Electrical</Attr> 
				<Attr Value="P" >Public Health</Attr> 
				<Attr Value="C" >Civil</Attr> 
			</Control> 
			<Control Label="Content Description" Order="4" MinChars="1" MaxChars="20" CacheValue="true" Prefix="_" Format="AlphaNumeric_"> 
				<Desc>Model Content Description (only characters A-Z,1,2,3... are allowed)</Desc> 
			</Control> 
		</Filename> 
		…
</SFNSettings>

此外，还必须为上述指定的 Model、ModelDesign、ModelDrawing、ModelSheet 和 ModelNamedView 创建类似的子节点。 创建 XML 文档之后，将其保存在可供 OpenBuildings Designer 访问的文件夹位置。请记住此文件位置！

接下来，在配置变量中，选择“文件保存”组并找到名为“BB_NAMING_STANDARDS_FILE”的变量。将此变量编辑为刚才创建的 XML 文件的提取路径。然后选择“BB_NAMING_STANDARDS_ENABLE”变量，并确保其值已设置为“true”。

下次创建新文件时，SFN 实用工具应在“保存文件”对话框显示之前弹出。如果出现关于 XML 文件的错误消息，则验证 XML 是否遵循架构规范。

父主题: 基础知识